<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  
  <title>Hexo学习 | 澹台灭明的博客</title>
  <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1">
  <meta name="description" content="记录一些简单的Hexo命令。 安装前提环境：Node.jsGit对于在Windows平台安装Git工具，我个人推荐图形化工具Git Extensions，更方便易学。 安装Hexo所有必备的应用程序安装完成后，即可使用 npm 安装 Hexo。​ 1$ npm install -g hexo-cli 配置初始化项目安装 Hexo 完成后，在指定路径初始化项目。 123$ hexo init &amp;lt">
<meta name="keywords" content="Hexo">
<meta property="og:type" content="article">
<meta property="og:title" content="Hexo学习">
<meta property="og:url" content="http://hitfyd.gitee.com/2017/11/07/Hexo学习/index.html">
<meta property="og:site_name" content="澹台灭明的博客">
<meta property="og:description" content="记录一些简单的Hexo命令。 安装前提环境：Node.jsGit对于在Windows平台安装Git工具，我个人推荐图形化工具Git Extensions，更方便易学。 安装Hexo所有必备的应用程序安装完成后，即可使用 npm 安装 Hexo。​ 1$ npm install -g hexo-cli 配置初始化项目安装 Hexo 完成后，在指定路径初始化项目。 123$ hexo init &amp;lt">
<meta property="og:locale" content="zh-CN">
<meta property="og:updated_time" content="2017-11-25T10:39:04.477Z">
<meta name="twitter:card" content="summary">
<meta name="twitter:title" content="Hexo学习">
<meta name="twitter:description" content="记录一些简单的Hexo命令。 安装前提环境：Node.jsGit对于在Windows平台安装Git工具，我个人推荐图形化工具Git Extensions，更方便易学。 安装Hexo所有必备的应用程序安装完成后，即可使用 npm 安装 Hexo。​ 1$ npm install -g hexo-cli 配置初始化项目安装 Hexo 完成后，在指定路径初始化项目。 123$ hexo init &amp;lt">
  
    <link rel="alternate" href="/atom.xml" title="澹台灭明的博客" type="application/atom+xml">
  
  
    <link rel="icon" href="/favicon.png">
  
  
    <link href="//fonts.googleapis.com/css?family=Source+Code+Pro" rel="stylesheet" type="text/css">
  
  <link rel="stylesheet" href="/css/style.css">
  

</head>

<body>
  <div id="container">
    <div id="wrap">
      <header id="header">
  <div id="banner"></div>
  <div id="header-outer" class="outer">
    <div id="header-title" class="inner">
      <h1 id="logo-wrap">
        <a href="/" id="logo">澹台灭明的博客</a>
      </h1>
      
        <h2 id="subtitle-wrap">
          <a href="/" id="subtitle">以貌取人，失之子羽。</a>
        </h2>
      
    </div>
    <div id="header-inner" class="inner">
      <nav id="main-nav">
        <a id="main-nav-toggle" class="nav-icon"></a>
        
          <a class="main-nav-link" href="/">Home</a>
        
          <a class="main-nav-link" href="/archives">Archives</a>
        
      </nav>
      <nav id="sub-nav">
        
          <a id="nav-rss-link" class="nav-icon" href="/atom.xml" title="RSS Feed"></a>
        
        <a id="nav-search-btn" class="nav-icon" title="搜索"></a>
      </nav>
      <div id="search-form-wrap">
        <form action="//google.com/search" method="get" accept-charset="UTF-8" class="search-form"><input type="search" name="q" class="search-form-input" placeholder="Search"><button type="submit" class="search-form-submit">&#xF002;</button><input type="hidden" name="sitesearch" value="http://hitfyd.gitee.com"></form>
      </div>
    </div>
  </div>
</header>
      <div class="outer">
        <section id="main"><article id="post-Hexo学习" class="article article-type-post" itemscope itemprop="blogPost">
  <div class="article-meta">
    <a href="/2017/11/07/Hexo学习/" class="article-date">
  <time datetime="2017-11-07T13:46:25.000Z" itemprop="datePublished">2017-11-07</time>
</a>
    
  <div class="article-category">
    <a class="article-category-link" href="/categories/Tool/">Tool</a>
  </div>

  </div>
  <div class="article-inner">
    
    
      <header class="article-header">
        
  
    <h1 class="article-title" itemprop="name">
      Hexo学习
    </h1>
  

      </header>
    
    <div class="article-entry" itemprop="articleBody">
      
        <p>记录一些简单的<a href="https://hexo.io/zh-cn/" target="_blank" rel="external">Hexo</a>命令。</p>
<h2 id="安装"><a href="#安装" class="headerlink" title="安装"></a>安装</h2><h3 id="前提环境："><a href="#前提环境：" class="headerlink" title="前提环境："></a>前提环境：</h3><p><a href="http://nodejs.org/" target="_blank" rel="external">Node.js</a><br><a href="http://git-scm.com/" target="_blank" rel="external">Git</a><br>对于在Windows平台安装Git工具，我个人推荐图形化工具<a href="http://gitextensions.github.io/" target="_blank" rel="external">Git Extensions</a>，更方便易学。</p>
<h3 id="安装Hexo"><a href="#安装Hexo" class="headerlink" title="安装Hexo"></a>安装Hexo</h3><p>所有必备的应用程序安装完成后，即可使用 npm 安装 Hexo。​</p>
<figure class="highlight plain"><table><tr><td class="gutter"><pre><div class="line">1</div></pre></td><td class="code"><pre><div class="line">$ npm install -g hexo-cli</div></pre></td></tr></table></figure>
<h2 id="配置"><a href="#配置" class="headerlink" title="配置"></a>配置</h2><h3 id="初始化项目"><a href="#初始化项目" class="headerlink" title="初始化项目"></a>初始化项目</h3><p>安装 Hexo 完成后，在指定路径初始化项目。</p>
<figure class="highlight plain"><table><tr><td class="gutter"><pre><div class="line">1</div><div class="line">2</div><div class="line">3</div></pre></td><td class="code"><pre><div class="line">$ hexo init &lt;folder&gt; //例如E:\blog</div><div class="line">$ cd &lt;folder&gt;</div><div class="line">$ npm install</div></pre></td></tr></table></figure>
<h3 id="修改配置文件"><a href="#修改配置文件" class="headerlink" title="修改配置文件"></a>修改配置文件</h3><p>在项目根目录的_config.yml （区别于themes文件夹中不同主题下的_config.yml）中修改配置，简单只修改几个参数即可。</p>
<table>
<thead>
<tr>
<th style="text-align:center">参数</th>
<th style="text-align:center">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:center">title</td>
<td style="text-align:center">网站标题</td>
</tr>
<tr>
<td style="text-align:center">subtitle</td>
<td style="text-align:center">网站副标题</td>
</tr>
<tr>
<td style="text-align:center">description</td>
<td style="text-align:center">网站描述</td>
</tr>
<tr>
<td style="text-align:center">author</td>
<td style="text-align:center">作者名字</td>
</tr>
<tr>
<td style="text-align:center">url</td>
<td style="text-align:center">博客网址，例如<a href="http://xxx.com" target="_blank" rel="external">http://xxx.com</a></td>
</tr>
<tr>
<td style="text-align:center">root</td>
<td style="text-align:center">网站根目录，例如博客在<a href="http://xxx.com/blog/" target="_blank" rel="external">http://xxx.com/blog/</a>，则根目录是/blog/</td>
</tr>
</tbody>
</table>
<h2 id="写作"><a href="#写作" class="headerlink" title="写作"></a>写作</h2><p>将写好的Markdown文件放在\source_posts文件夹下即可。</p>
<h3 id="generate"><a href="#generate" class="headerlink" title="generate"></a>generate</h3><figure class="highlight plain"><table><tr><td class="gutter"><pre><div class="line">1</div></pre></td><td class="code"><pre><div class="line">$ hexo generate</div></pre></td></tr></table></figure>
<p>生成静态文件。</p>
<h3 id="server"><a href="#server" class="headerlink" title="server"></a>server</h3><figure class="highlight plain"><table><tr><td class="gutter"><pre><div class="line">1</div></pre></td><td class="code"><pre><div class="line">$ hexo server</div></pre></td></tr></table></figure>
<p>启动本地服务器查看网页。默认情况下，访问网址为： <a href="http://localhost:4000/" target="_blank" rel="external">http://localhost:4000/</a>。</p>
<h2 id="写作标签"><a href="#写作标签" class="headerlink" title="写作标签"></a>写作标签</h2><h3 id="Front-matter"><a href="#Front-matter" class="headerlink" title="Front-matter"></a>Front-matter</h3><p>Front-matter 是文件最上方以 — 分隔的区域，用于指定文件的部分变量，例如本文的Front-matter为：</p>
<figure class="highlight plain"><table><tr><td class="gutter"><pre><div class="line">1</div><div class="line">2</div><div class="line">3</div><div class="line">4</div><div class="line">5</div></pre></td><td class="code"><pre><div class="line">title: Hexo学习</div><div class="line">date: 2017/11/07 21:46:25</div><div class="line">categories: Tool </div><div class="line">tags: Hexo</div><div class="line">---</div></pre></td></tr></table></figure>
<h3 id="资源图片"><a href="#资源图片" class="headerlink" title="资源图片"></a>资源图片</h3><p>如果想在文章中显示图片和其他资源，需要开启资源文件管理功能，通过将 <em>config.yml</em> 文件中的 <em>post_asset_folder</em> 选项设为 <em>true</em> 来打开。</p>
<figure class="highlight plain"><table><tr><td class="gutter"><pre><div class="line">1</div><div class="line">2</div></pre></td><td class="code"><pre><div class="line">_config.yml</div><div class="line">post_asset_folder: true</div></pre></td></tr></table></figure>
<p>当资源文件管理功能打开后， markdown 文件所在文件夹下会有一个同名资源文件夹，可以将资源放在这个关联文件夹中通过相对路径来引用它们。</p>
<h3 id="相对路径引用的标签插件"><a href="#相对路径引用的标签插件" class="headerlink" title="相对路径引用的标签插件"></a>相对路径引用的标签插件</h3><p>常规的markdown语法和相对路径来引用图片和其他资源可能会导致它们在存档页或者主页上显示不正确。此时应该使用Hexo的标签插件：</p>
<figure class="highlight plain"><table><tr><td class="gutter"><pre><div class="line">1</div><div class="line">2</div><div class="line">3</div></pre></td><td class="code"><pre><div class="line">&#123;% asset_path slug %&#125;</div><div class="line">&#123;% asset_img slug [title] %&#125;</div><div class="line">&#123;% asset_link slug [title] %&#125;</div></pre></td></tr></table></figure>
<p>比如说：当你打开文章资源文件夹功能后，你把一个 example.jpg 图片放在了你的资源文件夹中，如果通过使用相对路径的常规 markdown 语法 </p>
<figure class="highlight plain"><table><tr><td class="gutter"><pre><div class="line">1</div></pre></td><td class="code"><pre><div class="line">![](/example.jpg)</div></pre></td></tr></table></figure>
<p>它将不会出现在首页上（但是它会在文章中按你期待的方式工作）。<br>正确的引用方式是使用下列标签插件：</p>
<figure class="highlight plain"><table><tr><td class="gutter"><pre><div class="line">1</div></pre></td><td class="code"><pre><div class="line">&#123;% asset_img example.jpg This is an example image %&#125;</div></pre></td></tr></table></figure>
<p>这样图片将会同时出现在文章、主页以及归档页中。</p>
<h2 id="发布"><a href="#发布" class="headerlink" title="发布"></a>发布</h2><p>首先，修改根目录下的_config.yml 配置文件。​</p>
<figure class="highlight plain"><table><tr><td class="gutter"><pre><div class="line">1</div><div class="line">2</div><div class="line">3</div><div class="line">4</div><div class="line">5</div></pre></td><td class="code"><pre><div class="line">deploy:</div><div class="line">  type: git</div><div class="line">  repo: &lt;repository url&gt;</div><div class="line">  branch: [branch]</div><div class="line">  message: [message]</div></pre></td></tr></table></figure>
<table>
<thead>
<tr>
<th style="text-align:center">参数</th>
<th style="text-align:center">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:center">type</td>
<td style="text-align:center">部署类型，可以有多个，会依次部署</td>
</tr>
<tr>
<td style="text-align:center">repo</td>
<td style="text-align:center">库地址，例如 <a href="https://xxx.git" target="_blank" rel="external">https://xxx.git</a></td>
</tr>
<tr>
<td style="text-align:center">branch</td>
<td style="text-align:center">分支名称</td>
</tr>
<tr>
<td style="text-align:center">message</td>
<td style="text-align:center">提交信息 (默认为更新时间)</td>
</tr>
</tbody>
</table>
<h3 id="deploy"><a href="#deploy" class="headerlink" title="deploy"></a>deploy</h3><figure class="highlight plain"><table><tr><td class="gutter"><pre><div class="line">1</div></pre></td><td class="code"><pre><div class="line">$ hexo deploy</div></pre></td></tr></table></figure>
<p>部署网站，可能会需要输入账号密码。</p>
<h3 id="生成并部署"><a href="#生成并部署" class="headerlink" title="生成并部署"></a>生成并部署</h3><p>可以让 Hexo 在生成完毕后自动部署网站，下列两个命令的作用是相同的。</p>
<figure class="highlight plain"><table><tr><td class="gutter"><pre><div class="line">1</div><div class="line">2</div></pre></td><td class="code"><pre><div class="line">$ hexo generate --deploy</div><div class="line">$ hexo deploy --generate</div></pre></td></tr></table></figure>
<p>上面两个命令可以简写为</p>
<figure class="highlight plain"><table><tr><td class="gutter"><pre><div class="line">1</div><div class="line">2</div></pre></td><td class="code"><pre><div class="line">$ hexo g -d</div><div class="line">$ hexo d -g</div></pre></td></tr></table></figure>

      
    </div>
    <footer class="article-footer">
      <a data-url="http://hitfyd.gitee.com/2017/11/07/Hexo学习/" data-id="cjai5buzo00011ov4xdboip3i" class="article-share-link">Share</a>
      
      
  <ul class="article-tag-list"><li class="article-tag-list-item"><a class="article-tag-list-link" href="/tags/Hexo/">Hexo</a></li></ul>

    </footer>
  </div>
  
    
<nav id="article-nav">
  
    <a href="/2017/11/08/云主机价格比较/" id="article-nav-newer" class="article-nav-link-wrap">
      <strong class="article-nav-caption">Newer</strong>
      <div class="article-nav-title">
        
          云主机价格比较
        
      </div>
    </a>
  
  
    <a href="/2017/11/07/Hello World!/" id="article-nav-older" class="article-nav-link-wrap">
      <strong class="article-nav-caption">Older</strong>
      <div class="article-nav-title">Hello World!</div>
    </a>
  
</nav>

  
</article>

</section>
        
          <aside id="sidebar">
  
    
  <div class="widget-wrap">
    <h3 class="widget-title">分类</h3>
    <div class="widget">
      <ul class="category-list"><li class="category-list-item"><a class="category-list-link" href="/categories/Learn/">Learn</a></li><li class="category-list-item"><a class="category-list-link" href="/categories/Tool/">Tool</a></li><li class="category-list-item"><a class="category-list-link" href="/categories/拾遗/">拾遗</a></li></ul>
    </div>
  </div>


  
    
  <div class="widget-wrap">
    <h3 class="widget-title">标签</h3>
    <div class="widget">
      <ul class="tag-list"><li class="tag-list-item"><a class="tag-list-link" href="/tags/Android/">Android</a></li><li class="tag-list-item"><a class="tag-list-link" href="/tags/FreeSWITCH/">FreeSWITCH</a></li><li class="tag-list-item"><a class="tag-list-link" href="/tags/Hexo/">Hexo</a></li><li class="tag-list-item"><a class="tag-list-link" href="/tags/PJSIP/">PJSIP</a></li><li class="tag-list-item"><a class="tag-list-link" href="/tags/SIP/">SIP</a></li><li class="tag-list-item"><a class="tag-list-link" href="/tags/Ubuntu/">Ubuntu</a></li><li class="tag-list-item"><a class="tag-list-link" href="/tags/miniSIPServer/">miniSIPServer</a></li><li class="tag-list-item"><a class="tag-list-link" href="/tags/云主机/">云主机</a></li></ul>
    </div>
  </div>


  
    
  <div class="widget-wrap">
    <h3 class="widget-title">标签云</h3>
    <div class="widget tagcloud">
      <a href="/tags/Android/" style="font-size: 10px;">Android</a> <a href="/tags/FreeSWITCH/" style="font-size: 10px;">FreeSWITCH</a> <a href="/tags/Hexo/" style="font-size: 10px;">Hexo</a> <a href="/tags/PJSIP/" style="font-size: 10px;">PJSIP</a> <a href="/tags/SIP/" style="font-size: 15px;">SIP</a> <a href="/tags/Ubuntu/" style="font-size: 20px;">Ubuntu</a> <a href="/tags/miniSIPServer/" style="font-size: 10px;">miniSIPServer</a> <a href="/tags/云主机/" style="font-size: 15px;">云主机</a>
    </div>
  </div>

  
    
  <div class="widget-wrap">
    <h3 class="widget-title">归档</h3>
    <div class="widget">
      <ul class="archive-list"><li class="archive-list-item"><a class="archive-list-link" href="/archives/2018/05/">五月 2018</a></li><li class="archive-list-item"><a class="archive-list-link" href="/archives/2017/11/">十一月 2017</a></li></ul>
    </div>
  </div>


  
    
  <div class="widget-wrap">
    <h3 class="widget-title">最新文章</h3>
    <div class="widget">
      <ul>
        
          <li>
            <a href="/2018/05/08/PJSIP Android编译/">PJSIP Android编译</a>
          </li>
        
          <li>
            <a href="/2017/11/27/在Ubuntu上编译安装FreeSWITCH/">在Ubuntu上编译安装FreeSWITCH</a>
          </li>
        
          <li>
            <a href="/2017/11/25/在云主机上安装、部署和调试miniSIPServer/">在云主机上安装、部署和调试miniSIPServer</a>
          </li>
        
          <li>
            <a href="/2017/11/08/云主机价格比较/">云主机价格比较</a>
          </li>
        
          <li>
            <a href="/2017/11/07/Hexo学习/">Hexo学习</a>
          </li>
        
      </ul>
    </div>
  </div>

  
</aside>
        
      </div>
      <footer id="footer">
  
  <div class="outer">
    <div id="footer-info" class="inner">
      &copy; 2018 hitfyd@foxmail.com<br>
      Powered by <a href="http://hexo.io/" target="_blank">Hexo</a>
    </div>
  </div>
</footer>
    </div>
    <nav id="mobile-nav">
  
    <a href="/" class="mobile-nav-link">Home</a>
  
    <a href="/archives" class="mobile-nav-link">Archives</a>
  
</nav>
    

<script src="//ajax.googleapis.com/ajax/libs/jquery/2.0.3/jquery.min.js"></script>


  <link rel="stylesheet" href="/fancybox/jquery.fancybox.css">
  <script src="/fancybox/jquery.fancybox.pack.js"></script>


<script src="/js/script.js"></script>

  </div>
</body>
</html>